home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 4 / Meeting Pearls Vol. IV (1996)(GTI - Schatztruhe)[!].iso / Pearls / texmf / doc / latex / base / amiweb2c.txt < prev    next >
Text File  |  1996-06-19  |  9KB  |  252 lines
  1.  
  2.  
  3.              LaTeX installation instructions for AmiWeb2C TeX
  4.  
  5.                              10 December 1995
  6.  
  7.  
  8. SUMMARY
  9. =======
  10.  
  11. This file contains instructions on how to install LaTeX for Web2C TeX
  12. on the Amiga (AmiWeb2C).  Before reading this file, you should read
  13. install.txt, which will explain how the LaTeX installation works.
  14.  
  15. This file describes:
  16.  
  17.  * How to save any old version of LaTeX.
  18.  
  19.  * How to configure LaTeX.
  20.  
  21.  * How to unpack the LaTeX distribution.
  22.  
  23.  * How to install the LaTeX files.
  24.  
  25.  * How to create the LaTeX format.
  26.  
  27.  * What to do if you have any problems.
  28.  
  29.  
  30. REQUIREMENTS
  31. ============
  32.  
  33. In addition to the LaTeX distribution files, you will also need the
  34. following:
  35.  
  36.  * the file `hyphen.cfg' coming with the source distribution of AmiWeb2C,
  37.    loading hyphenation patterns for US English (ushyph1.tex) and UK English
  38.    (ukhyphen.tex), German (ghyph31.tex), and French (fhyphen.tex).  In the
  39.    commentary section of `hyphen.cfg' a list of many other languages is
  40.    given together with references to pattern files.  You may freely modify
  41.    `hyphen.cfg' to suit your personal needs.
  42.  
  43.  
  44. SAVING ANY OLD VERSION OF LATEX
  45. ===============================
  46.  
  47. Nobody should ever have installed LaTeX 2.09 with AmiWeb2C (which was
  48. avaible in April/May 1995), so there is no need for special treatment
  49. of such an old version of LaTeX.
  50.  
  51.  
  52. CONFIGURING LATEX
  53. =================
  54.  
  55. During the installation procedure, it may be easiest to set some temporary
  56. device names.
  57.  
  58. The LATEXINPUTS:  directory is where the LaTeX base packages and classes
  59. will finally be installed.  In the `TeX Directory Structure' assumed by
  60. AmiWeb2C this defaults to:
  61.  
  62.    assign LATEXINPUTS: TeXMF:tex/latex/base
  63.  
  64. The LATEXFORMAT: directory is where the LaTeX format is kept.  This is:
  65.  
  66.    assign LATEXFORMAT: TeXMF:web2c/formats/latex
  67.  
  68. The LATEXDIST: directory is where the LaTeX distribution is kept.  This is:
  69.  
  70.    assign LATEXDIST: TeXMF:source/latex/base
  71.  
  72. You should put all files coming with the base distribution of LaTeX in the
  73. LATEXDIST:  directory.  After the successful installation procedure, you
  74. can safely remove the complete LATEXDIST:  directory.
  75.  
  76. If you have installed the Amiga port of Web2C from scratch, you will not
  77. have to edit the file texsys.cfg at all (when the installation procedure
  78. prompts you that it can't find texsys.cfg, simply type <return>).  If you
  79. started with the ready-to-use binaries, I suggest that you get Martin
  80. Scott's `UnixDirsII' package from the AmiNet:
  81.  
  82.    AmiNet:/util/shell/UnixDirsII.lha
  83.  
  84. (This archive is also available on Fred Fish's AmigaLibDisk 837.) This
  85. program patches the AmigaOS so that the UNIX notations `.' and `..' are
  86. enabled for the `current' and the `parent' directory respectively.
  87.  
  88.  
  89. UNPACKING THE DISTRIBUTION
  90. ==========================
  91.  
  92. To unpack the LaTeX distribution, you should:
  93.  
  94.    cd LATEXDIST:
  95.    tex -ini unpack.ins
  96.  
  97. This may take 15 to 20 minutes on a 50 MHz 68030, but considerably longer
  98. on a standard 7.19 MHz 68000 (approximately 4 hours).  Why don't you just
  99. go and make a good cup of coffee?
  100.  
  101.  
  102. PUTTING THE FILES WHERE LATEX CAN READ THEM
  103. ===========================================
  104.  
  105. How was your coffee?  To install the LaTeX files created in the previous
  106. step, you should:
  107.  
  108.    cd LATEXDIST:
  109.    copy latexbug.tex testpage.tex lablst.tex idx.tex ltxcheck.tex +
  110.       nfssfont.tex small2e.tex sample2e.tex docstrip.tex +
  111.       #?.cls #?.clo #?.sty #?.fd #?.def #?.cfg #?.ltx +
  112.    LATEXINPUTS:
  113.  
  114. (The `+' character means that you should type this as a single command.)
  115. If you have MakeIndex installed or intend to do so, copy #?.ist to the
  116. MakeIndex inputs directory, which should be in TDS notation:
  117.  
  118.    setenv INDEXSTYLE TeXMF:makeindex/styles
  119.  
  120.  
  121. CREATING THE LATEX FORMAT
  122. =========================
  123.  
  124. After the unpacked files of the LaTeX distribution are installed at the
  125. appropriate place, you have to create the LaTeX format proper.  This will
  126. conveniently be done by the following commands:
  127.  
  128.    cd LATEXFORMAT:
  129.    tex -ini latex.ltx
  130.  
  131. Thus the format file latex.fmt will be created at the correct place and
  132. also the correctness of the installation will be tested, because the
  133. necessary files will be read from the appropriate paths.
  134.  
  135. You have now installed LaTeX!
  136.  
  137.  
  138. GETTING A WORKING LATEX
  139. =======================
  140.  
  141. Add the following lines to your User-StartUp file in the S: directory:
  142.  
  143.    alias ELaTeX  "tex &latex \language=\USenglish \input "
  144.    alias GLaTeX  "tex &latex \language=\german \input "
  145.    alias MyLaTeX "tex &latex \language=\<mylanguage> \input "
  146.  
  147. For the time being until you next reboot your system, you should type these
  148. (and possibly other) commands on the command line input.  A list of such
  149. aliases is included in the file `TeXMF:source/s/User-StartUp.entry' which
  150. may serve as an example.
  151.  
  152.  
  153. CHECKING THAT THE INSTALLATION WORKED
  154. =====================================
  155.  
  156. To check that the installation worked, you should:
  157.  
  158.    cd LATEXFORMAT:
  159.    latex ltxcheck
  160.  
  161. This will perform a number of tests, which should all report `OK'.
  162.  
  163.  
  164. PROBLEMS
  165. ========
  166.  
  167. `texsys.cfg':  While running IniTeX on latex.ltx you will be prompted
  168.    that this file can't be found on your system.  This is a feature!
  169.    Given that you have `UnixDirsII' installed you may safely continue
  170.    by typing <return>.  The standard notation `./' for the `current'
  171.    directory will be assumed.
  172.  
  173. `File missing':  As long as the default search paths of AmiWeb2C are
  174.    correctly set up and used, you won't encounter this message.
  175.  
  176. `Font missing':  Some of the fonts, i.e., tfm files, required by LaTeX
  177.    are missing.  In addition to the 75 standard fonts of the `Computer
  178.    Modern' family, several additional fonts are needed.  Run MetaFont
  179.    on the respective font drivers and install the tfm files in the
  180.    TeXMF:fonts/tfm// directory structure.
  181.  
  182. `Out of memory':  The memory configuration file `texmf.cnf' coming with the
  183.    source distribution of AmiWeb2C was used for the installation of LaTeX
  184.    on my system, so it should be appropriate for your machine too.  Since
  185.    AmiWeb2C is directly descended from the UNIX Web2C distribution, its
  186.    binaries are designed for a BigTeX configuration.  If you really  want
  187.    to install it on machines with less than 2 MB of RAM, you will most
  188.    likely have to restrict yourself to a single language in `hyphen.cfg'
  189.    and comment the value for `triesize' in `texmf.cnf' in order to start
  190.    IniTeX.
  191.  
  192.  
  193. CLEARING UP
  194. ===========
  195.  
  196. You may now be wondering what to do with all the remaining files that are
  197. not needed to run LaTeX.  This is, of course, a matter of personal taste
  198. and availability of disk space but here is some guidance.
  199.  
  200.  * The files with extension .dtx, together with source2e.tex, can be used
  201.    to typeset the documented source code (see texpert.txt for further
  202.    information).
  203.  
  204.  * The files with extension .fdd contain the documented sources for the
  205.    font definition files.
  206.  
  207.  * The files ltnews<xx>.tex and ltnews<xx>.ps both contain the lastest
  208.    LaTeX newsletter.
  209.  
  210.  * The files with extension .txt contain information about (amongst other
  211.    things) copyright, installation, patches and bug-reports; and those
  212.    with extension .err contain errata lists for various publications:
  213.    see 00readme.txt for further details.
  214.  
  215.  * The files with names of the form <xxx>guide.tex contain reference
  216.    information convering only those features new to this version of LaTeX:
  217.    they are not intended to be either a user guide or a complete reference.
  218.  
  219.  * The files with extension .ltx, together with latexcheck.tex, are used
  220.    to create and test the format; therefore you should keep these together
  221.    with the installed LaTeX system in the LATEXINPUTS: directory if you
  222.    expect to remake the format before getting the next full distribution.
  223.  
  224.  * The files with extension .ins are used to unpack the code from the
  225.    .dtx and .fdd files.
  226.  
  227.  * We recommend that you keep, in the LATEXFORMAT: directory, the
  228.    transcript file latex.log that was produced whilst creating the format.
  229.  
  230. If you don't need the documentation or if you are lacking enough disk
  231. space to permanently keep the LaTeX distribution files, you can now safely:
  232.  
  233.    delete LATEXDIST:#?
  234.  
  235.  
  236. SYSTEM-SPECIFIC SECTIONS
  237. ========================
  238.  
  239. As the maintainer and distributor of AmiWeb2C I'm very interested in any
  240. feedback about problems with the application of this TeX system for the
  241. Amiga.  Please report difficulties in installing and/or using LaTeX that
  242. are clearly related to any (mis)feature of AmiWeb2C to
  243.  
  244.    Andreas Scherer
  245.    Roland-Stra{\ss}e 16
  246.    52070 Aachen, Germany
  247.    <scherer@physik.rwth-aachen.de>
  248.  
  249.  
  250. --- Copyright 1995 Andreas Scherer and the LaTeX3 project. ---
  251. ---                 All rights reserved.                   ---
  252.